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PREFACE 



CONTROL DATA CORPORATION ® UNIPLOT • (Uni- 
versal Plottii^ Software) is a set of basic plotting routines 
which link a CalComp-compatible application prc^ram 
with supported plotters or g^raphie devices. UNIPLOT is 
composed of two software components: (1) a set of 
CalComp caU-compatible neutral plot routines, and (2) a 
post processor. Called by a user's application program, 
the neutral plot routines generate a neutral picture file. 
This file contains a sequence of pictures which may be 
separately accessed and plotted by the post processor. 

The primary function of this publication is to describe the 
neutral plot routines and post processor and how they are 
used. UNIPLOT can be used with the following operating 
systems and supported devices. 

• CDC® CYBERNET® users can employ CDC 
UNIPLOT under the CYBERNET. SCOPE 3.4 and 
NOS 1.0 operating systems. 

• Systems users can employ CDC UNIPLOT under 
either the NOS or NOS/BE operating systems. 

• Refer to appendix D for a list of supported 
devices. 

This manual assumes user familiarity with FORTRAN 
Extended, standard CalComp routines, and CDC NOS or 
NOS/BE operating systems. 

Control Data manuals which may relate to the operation 
of CDC UNIPLOT under CYBERNET Service include: 



Publication 

Publication Number 

CYBERNET NOS User's Reference 

Manual 84000029 

CYBERNET SCOPE 3.4 Reference 

Manual 60307200 

CYBERNET FORTRAN Extended 

4 Reference Manual 60497800 

CYBER Loader Reference Manual 60429800 

CYBERNET UPDATE Reference 

Manual 60342500 

777 IGS Reference Manual 16321800 



Publication 

Publication Number 

777 IGS User's Guide 17322500 

LCGT IGS Reference Manual 76079100 

LCGT IGS User's Guide 76077400 

Beginning Graphics User's Guide 76077300 

UNISTRUC Reference 

Manual 76076800 

GODAS V3.0 User's Guide, 

Volume 2 76076300 



Control Data publications that may relate to the opera- 
tion of CDC UNIPLOT under NOS/BE include: 



Publication 

Publication Number 

NOS/BE Reference Manual 60493800 

FORTRAN Extended 4 Reference 

Manual 60497800 

INTERCOM Reference Manual 60494600 

CYBER Loader Reference Manual 60429800 

Record Manager Reference Manual 60495700 

UPDATE Reference Manual 60449900 

777 IGS Reference Manual 17321800 

777 IGS User's Guide 17322500 

777 IGS Remote Job Entry User's 

Guide 76077200 

LCGT IGS Reference Manual 76079100 

LCGT IGS User's Guide 76077400 

Beginnit^ Graphics User's Guide 76077300 
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INTRODUCTION 



GENERAL DESCRIPTION 



NEUTRAL PLOT ROUTINES 



UNIPLOT, Universal Plotting Software, is a set of 
FORTRAN routines which are CalComp call-compatible. 
These routines write a neutral file which can then be read 
by a post processor to produce output for a variety of 
plotters. UNIPLOT is designed to be used by all 
applications programs which make CalComp calls to 
produce graphic output in batch mode. Pr(^rams which 
require real-time or interactive graphic displays are not 
supported. Figure 1-1 illustrates an overview to UNIPLOT 
processing. 

UNIPLOT provides the user with great flexibility in the 
selection of a device for displaying graphic output. Even 
after an application program is finished, the user main- 
tains control over the display device, drawii^ scale, 
drawing layout on a display surface, mirroring of the 
drawing, and windowii^ (displaying only a selected rectan- 
gular portion of a drawing). 



The neutral plot routines are called by a user's application 
program in the same manner as standard CalComp 
routines. However, instead of producing a file that drives 
only a single CalComp plotter, the neutral plot routines 
create what is called a neutral picture file. This file, in 
turn, contains a sequence of pictures, each of which may 
be accessed and plotted separately on a variety of devices 
by executii^ the post processor. 

UNIPLOT includes a wide variety of neutral plot routines 
which perform a number of functions such as generating 
vectors, character strings, arcs and curves, structuring 
the plot data into pictures and figures, controlling the 
placement of pictures on a display surface, and manipu- 
latii^ data in order to mirror, offset, and scale display 
elements before they are placed in the picture file. 



POST PROCESSOR 



SYSTEM COMPONENTS 

The UNIPLOT system is composed of two software com- 
ponents: a set of CDC neutral plot routines and a post 
processor. These components communicate through a 
standard format file known £is the neutral picture file. 



The post processor is a stand-alone program which reads 
the neutral picture file. The post processor can be 
instructed to modify the placement, scale, and rotation of 
each picture or a portion of each picture. The graphics 
data is translated into a format which is acceptable by the 
controller of the selected display device, and the picture 
may be produced directly on an on-line display device, or 
written to a tape for plotting on an off-line device. 
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USING THE NEUTRAL PLOT ROUTINES 



INITIALIZATION AND TERMINATION 

The neutral plot routines are called by an application 
program as are the CalComp Basic Plotting Software 
programs. An intermediate device-independent file, 
called the neutral picture file, is produced. This file 
contains a sequence of pictures made up of character 
string control and placement information and other 
graphic data. Each of these pictures may be accessed and 
plotted separately by the post processor. 

Initially, it is necessary to identify the neutral picture file 
to the neutral plot routines. This is accomplished in one 
of two ways: 

CALL PLTFIL(ldev) 

or via the standard CalComp routine 

CALL PLOTS(ibuf,nloc,ldev) 

Both of these calls are described later in this section, t It 
should be noted, however, that CALL PLTFIL and CALL 
PLOTS are used only once in an application program. 

Both routines contain dummy parameter strings for 
compatibility with UNIPLOT Version 1.0 and CalComp. 
However UNIPLOT Version 2.0 does not require any buffer 
space or logical file name from the eaUing program. The 
neutral plot routines wiU always create a neutral picture 
file called NPFILE. 

In addition to PLTFIL and PLOT calls, another call, 
NEWPLT, allows greater flexibility in defining individual 
pictures within the entire graphic output. 

The standard method of starting a new picture, defining a 
new origin with a etdl to PLOT with a negative pen 
command, is satisfactory for pen plotters. However, in 
order to display a picture properly on a CRT, the origin or 
beginnii^ must be known. Some of the application 
programs which produce CalComp output establish mul- 
tiple minor origins causing the original origin to be 
indistii^ishable. This problem can be overcome by using 
the routine NEWPLT. The format is: 

CALL NEWPLT(level,xmin,ymin,xmax,ymax,xloc, 
yloc,irot,name) 

The size of the total picture is defined by the 
xmin,ymin,xmax and ymax arguments on the NEWPLT 
call. A rectangle drawn through these coordinates defines 
a f^ame or window around the picture. The lower left- 
hand corner of this rectangle is placed at the xloc,yloc 
position on the display surface if the post-processor is 
executed in FILE mode. 

Included In the picture defined by a NEWPLT call are one 
or more figures defined by a negative third argument. All 
coordinates in the figures must be within the rectangle 
defined by the minimum and maximum x and y arguments 
on the last caU to NEWPLT. 



UNIPLOT is not responsible for the resulting display if any 
vectors extend across the window boundaries of the 
picture. 

The final call which the application program makes to the 
neutral plot routines must be a call to the PLOT routine in 
the following form. 

CALL PLOT(x,y,999) 

This call empties the buffer of graphics data and ends the 
neutral picture file (refer to PLOT Routine described 
later In this section). It should only be called once in the 
program. 



WRITING GRAPHIC DATA 

This section briefly describes a number of the routines 
used to scale and write graphic data. The routines re- 
ferred to are described fuUy later in this section under 
Descriptions of the Neutral Plot Routines. 

Via the PLOT routine, the user can employ any of the 
following four kinds of lines: solid. Invisible, dashed, or 
dotted. Character strings and a variety of centered 
symbols are written via the SYMBOL routine. The 
UNIPLOT character set is described In appendix B, and 
the centered symbols are Illustrated in appendix C. 
Floating point numbers may be plotted as a string of 
digits, and punctuated, by the NUMBER routine. Circles 
or arcs may be drawn by either the ARC or ARC2 routine. 
The difference in these last two calls is in the manner in 
which the arc is specified. 

The SCALE, AXIS and LINE routines are designed to 
simplify the task of plotting graphs. SCALE inspects an 
array of data and computes a scale and a starting value 
which, when applied to the data, assures that the array 
will fall within a specified number of inches. The user 
specifies a scale factor in his pr<^ram using a 
SCALE=fact* directive, where fact is the factor by which 
the figure is to be scaled (magnified). Another directive, 
SCHAR=fact* allows the user program to scale text in a 
drawing while leaving the figure unchanged. 

The startii^ value and scale are stored In the Inspected 
array in the two locations beyond the last word inspected. 
Consequently, the DIMENSION statement should be at 
least two words larger than required by the array. The 
inspected data need not be contiguous in core, but may be 
separated by a given number of words. In this case the 
starting value and scale are placed at the last word 
address plus increment, and last word address plus two 
times the increment, respectively. 

The AXIS routine is used to generate the axes for a graph. 
It draws an axis with a linear scale, using the values 
computed by the SCALE routine or a SCALE and startii^ 
value calculated by the user, place tic marks on the axis, 
and label the axis with numbers and letters. 



t Refer to Descriptions of the Neutral Plot Routines in this section. 
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Instructions for writing a new device control routine are 
provided in appendix E of this manual. For instructions on 
loading the eorrespondir^ specific device control routine 
with the post processor, contact your local CDC analyst. 



Example: 

PROGRAM EXAMP (INPUT.OUTPUT) 



ERROR RETURNS 

New applications using the neutral plot routines may 
choose to use the ai^ument check and error return fea- 
ture. An additional integer argument may be added to 
calls to the neutral plot routines for which illegal 
argument combinations are possible. If the arguments to 
the routine are legal, this additional argument returns 
with a value of zero; if not, a value greater than zero is 
returned. The particular value indicates the type of error. 
The error codes are explained in appendix F. 



If a call is coded without the extra argument, 
parameters of that particular call are not checked. 



the 



For any given run, the error checking mode must be 
turned on by a call to routine ERRON. Subsequently, the 
mode may be turned off by a call to ERROFF. The error 
checking mode may be turned on and off any number of 
times during a run. 



DESCRIPTIONS OF THE NEUTRAL PLOT 
ROUTINES 

PLOTS ROUTINE 

The PLOTS routine initializes the neutral plot routines 
and starts the first picture. Figures cannot be included 
within a picture defined by a PLOTS call. 

Call format: 

CALL PLOTS(ibuf,nloc,ldev) 

ibuf Unused (Provided for compatibility with 
CalComp 

nloc Unused (Provided for compatibility with 
CalComp) 

Idev Unused (provided for compatibility with 
CalComp. UNIPLOT Version 2.0 always 
creates a neutral picture file name 
NPFILE.). 



CALL PLOTS 



Each time the PLOTS routine is called it opens a file 
named NPFILE. Subsequent calls to other neutral plot 
routines use that file as the neutral plot file. 

PLOTS also initializes the modal parameters of the 
neutral plot routines as shown in table 2-2. Thus PLOTS 
or PLTFIL must be called before any other UNIPLOT 
routine and should not be called more than once in a 
program. 



TABLE 2-2. INITIALIZING NEUTRAL PLOT 
ROUTINE PARAMETERS 



Parameter 


Initial Value 


Calling Routine 


XLOC 


0.0 


NEWPLT 


YLOC 


0.0 


NEWPLT 


FACT 


1.0 


FACTOR 


SCALEX 


1.0 


OFFSET 


SCALEY 


1.0 


OFFSET 


OFFSETX 


0.0 


OFFSET 


OFFSETY 


0.0 


OFFSET 


ZLINE 


0.0 


MIRROR 


RATIO 


1.0 


RATIO 
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c- 

c 

c- 

c- 

c 

c- 



c- 

c 

c- 



c- 

c 

c- 



PROdRAH EXAHPl (OUTPUT) 

INITIALIZE 

CALL PLTFIL 

CALL ROUTINE TO DEFINE AND FRAME A PICTURE 

CALL FRAME(0.0«0.0*«) 
CALL FRAME (3. 0*1 .0*2) 
CALL FRAME(6.0>0.0*S) 

TERMINATE PLOTTING 

CALL PLOTO. 0,-1. 0.999) 

ENO 

SUBROUTINE FRAME (X0R6*Y0R6, IC) 

ROUTINE TO DEFINE AND FRAME A PICTURE 

DATA XMIN*YMIN*XMAX,YMAX/^1.0,-1*0*1. 0*1.0/ 

CALL NENPLT(l,XMIN*YMIN*XMAX*YMAX«X0R6*YOR6*0«lH > 

CALL PLOT<1.0,1.0*-3> 

CALL PL0T(XMIN*YMIN*3) 

CALL PLOT < XMAX * YMIN • IC ) 

CALL PLOT<XNAX*YHAX*IC) 

CALL PL0T(XMIN*YMAX*IC) 

CALL PL0T<XMIN*YMIN,IC> 

RETURN 

END 







I 

U 



J 



Figure 2-1. NEWPLT Call 
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c 

c- 



c- 

c 

c- 



c- 

c 

c- 



PR06RAM EXAMP2 (OUTPUT) 

INITIALIZE AND DEFINE AND FRAME THE PICTURE 

CALL PLTFIL 

CALL NEWPLT(l»-1.5r-1.5t8«S*3.S»0.0*0.0*0tlH ) 

CALL PL0T(l,5,l,5»-3) 

CALL FRAME (2) 

ESTABLISH A FIGURE ORIGIN AND DRAW A 2 INCH SQUARE AROUND IT 

CALL PLOT<0.0»0.0*-3) 

CALL FRAME (♦) 

CALL PLOTO. 0,1. 0.-3) 

CALL FRAME (2) 

CALL PLOTO. 0,f.l,0»-3) 

CALL FRAME (5) 

TERMINATE PLOTTING 

CALL PLOTO. 0»-. 5, 999) 

END 

SUBROUTINE FRAME (IC) 

ROUTINE TO DRAW A FRAME USING DIFFERENT LINE STYLES 

DATA XMIN.YMlNfXMAX,YMAX/-1.5»-1.5«8.5,3.5/ 

CALL PL0T(XMIN»YMIN.3) 

CALL PLOT(XMAXtYM.IN,IC) 

CALL PLOT(XMAX»YMAX»IC» 

CALL PL0T(XMIN,YMAX,IC) 

CALL PLOT(XMlNfYMIN,IC> 

XMIN=YMIN=-1.0 

XMAX=YMAXsl.0 

RETURN 

END 




F^re 2-2. PLOT CaU 
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FACTOR ROUTINE 

The FACTOR routine sets the value of the modal pa- 
rameter, fact. The x,y coordinates are multiplied by fact 
causii^ the picture to be enlarged or reduced. The lower 
left comer of the window remains fixed. 

Call format: 

CALL FACTOR(fact) 

fact The ratio of the desired picture size to 
the default picture size. If fact is 2.0, 
aU vectors will be twice as long as the 
default when fact is 1.0. 



WHERE ROUTINE 

The WHERE routine returns to the calling program the 
current value of fact and the end-point coordinates of the 
last vector or character generated by the neutral plot 
routines and modified by the modal parameters. 

Call format: 



The SCALE routine examines the data values in an array 
and determines a starting value, either minimum or maxi- 
mum, and a scaling factor, positive or negative. The 
starting value determines that the scale annotation on the 
axis properly represents the data values in the array and 
that the data points plotted by the LINE routine fit on the 
display surface. These two values are computed and 
stored by SCALE at the end of the array. 

The scaling factor (scale) that is computed represents the 
number of data units per inch of axis, but is adjusted so 
that it is always an interval of 1, 2, 4, 5, or 8 x lO" (where 
n is an exponent consistent with the original unadjusted 
scaling factor). Thus, an array may have a range of values 
from 301 to 912, to be plotted over an axis of 10 inches. 
The unadjusted scaling factor is (912-301)/10 = 61.1 
units/inch. The adjusted scale would be 8 x 10^ = 80. 

The starting value (start), which appears as the first 
annotation on the axis, is computed as some multiple of 
scale that is equal to or outside the limits of the data in 
the array. For the example given above, if a minimum is 
wanted for start, 240 would be chosen as the best value. 
If a maximum is desired instead, 960 would be selected. 

Call format: 



CALL WHERE(x.y,fact) 

x,y The coordinates of the end-point of the 

last display element generated, with 
respect to the figure origin after modal 
parameters liave been applied. 

fact The current scale factor that multiplies 
all coordinates and sizes that are placed 
in the neutral picture file (set in a call 
to FACTOR). 



NEWPEN ROUTINE 

The NEWPEN routine allows the user to select which pen 
to use on a multipen plotter. 

Call format: 

CALL NEWPEN(ipen) 

ipen Pen number. 



SCALE ROUTINE 

A user's program usually contains virtual x and y coordi- 
nates in two arrays. It would be unusual if the range of 
values in each array corresponded exactly with the 
number of inches available on a display surface. For some 
problems the range of data is predictable, and the axis 
scale values can be predetermined by the prc^rammer. 
However, in general, these factors are not known in 
advance. 



CALL SCALE(array,axlen,npts,incr) 

array The first word of the array of data 
points to be examined. Array must be 
dimensioned by (npts+2)*incr. 

eixlen The length in inches of the axis to 
which the data is to be scaled. Its value 
must be greater than 1.0 inch. 

npts The number of data values to be 
scanned in the array. 

incr An integer whose absolute value is used 
by SCALE as the increment with which 
to select the data values to be scanned 
in the array. Normally incr equals 1; if 
it is 2, every other value is examined. 

If incr is positive, the selected starting 
value (start) approximates a minimum, 
and the scale factor (scale) is positive. 

If incr is negative, the selected starting 
value (start) approximates a maximum, 
and the scetlir^ factor (scale) is nega- 
tive. 

The startii^ value (start) calculated by SCALE is stored 
at ARRAY((NPTS+1)*INCR). The scale value (scale) is 
stored at ARRAY((NPTS+2)*INCR). 

SCALE is typically called twice, once for the X axis and 
once for the Y axis. 

An example of the use of the SCALE routine is included 
with the AXIS example in figure 2-4. 
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AXrS ROUTINE 

The AXIS routine draws an annotated axis. The SCALE 
routine can be used to compute the values of scale and 
start which produces an axis appropriate for plotting an 
array of values or the user can calculate his own scale and 
starting values. Typically, AXIS is called twice, once for 
the X axis and once for the Y axis. 

Call format: 

CALL AXIS(x,y,ititle,n,axlen,angle,start,scale) 

x,y Coordinate starting point of the axis 

relative to the origin of the last figure 
defined. 

ititle Array containing BCD title of the axis 
in AlO format. 

n The absolute value of n is the number of 

characters in the title. If n is greater 
than or equal to 0, title and annotation 
on counterclockwise side of axis. If n is 
less than 0, title and annotation on 
clockwise side of axis. 

axlen The angle, in degrees, of the axis with 
respect to the positive X axis. A posi- 
tive angle gives a counterclockwise 
rotation, a negative value gives clock- 
wise rotation. 

start The initial value of the axis, plotted at 
the first tie mark of the axis; it could 
be the value computed by the SCALE 
routine or a value specified by the user. 

scale The increment added to the starting 
value for each inch aloi^ the axis; it 
could be the value computed by the 
SCALE routine or a value specified by 
the user. 



LINE ROUTINE 

The LINE routine produces a line plot from a set of points 
stored in a matched pair of X and Y arrays. The points 
may be represented by centered symbols, and/or con- 
necting lines between points. 

There are two methods of sealing the line plot; the array 
method using the starting and scale values calculated by 
the SCALE routine or the parameter method usii^ the 
modal parameter offset, scalex, offsety, and scsiley, set 
by the OFFSET routine. 

Call format: 

CALL LINE(x,y,n,incr,ilin,isym) 

x,y Arrays containing the virtual coordi- 

nates to be plotted and the values 
calculated by SCALE or their equiva- 
lent supplied by the user. 



n The number of points in the arrays to be 

connected by the line not including the 
start and scale values. 

If n is positive, the array method of scalii^ is in force and 
the final three arguments of the call are interpreted as 
follows: 

incr The increment to be used in accessing 
the points in x and y (for example, incr 
equals 2 accesses every other value). 

ilin The absolute value of ilin is the occur- 

rence period of the centered symbols 
(for example, if the- absolute value of 
ilin equals 3, then every third point in 
x,y is marked by a centered symbol). If 
ilin equals 0, no centered symbols are 
drawn. If ilin greater than or equal to 
0, solid lines are drawn between the 
points. If ilin is less than 0, no lines are 
drawn between the points. 

isym The number of the centered symbol to 
be used (refer to appendix C for a list 
of symbols) or the line type to be used. 
If ilin equals and: 

If isym = 2, points are connected with 
solid lines. 

4, points are connected with 
dashed lines. 

5, points are connected with 
dotted lines. 

12, coordinates are modified 
by the modal parameters 
and connected by solid 
lines. 

14, coordinates are modified 
by the modal parameters 
and connected by dashed 
lines. 

15, coordinates are modified 
by the modal parameters 
and connected by dotted 
lines. 

If n is negative the parameter method is used to .scale the 
data, and the final three arguments in the call are 
interpreted as follows. 

incr The line type as specified in isym 
above. 

ilin The absolute value of ilin is the occur- 

rence period of the centered symbols. 

isym The number of the centered symbol to 
be used (refer to appendix C). 

When using the parameter method of scaling, LINE always 
enters arrays x and y using an increment of one (refer to 
figure 2-5). 
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CUBIC ROUTINE 



SYMBOL ROUTINE 



The CUBIC routine draws a cubic spline curve through the 
set of points specified by corresponding elements of 
arrays x and y (refer to figure 2-6). There must be at 
least four pairs of points. CUBIC is not affected by the 
values calculated by SCALE. 

Call format: 

CALL CUBIC(x,y,n,ic) 

x,y A matched set of arrays containing the 

X coordinates and y coordinates, respec- 
tively, of the points through which a 
smooth curve is drawn starting at point 
(x(l), y(l)), and ending at point (x{n), 
y(n)). 

n The number of coordinate pairs in the 

arrays x and y (n must be 4 or larger). 

ic An integer which selects the type of 

line used to draw the curve and controls 
the computation of the coordinates us- 
ii^ scales and offsets. Default is a 
solid line (2). 

If ic = 2, a solid line is selected. 

4, a dashed line is selected. 

5, a dotted line is selected. 

12, a solid line with coor- 
dinates computed using 
scales and offsets is se- 
lected. 

14, a dashed line with co- 
ordinates computed usir^ 
scales and offsets is se- 
lected. 

15, a dotted line with coor- 
dinates computed usir^ 
scales and offsets is se- 
lected. 



RATIO ROUTINE 

The RATIO routine sets the value of the modal parameter, 
ratio. This parameter controls the ratio of height to 
width of the alphanumeric characters and centered sym- 
bols drawn by routine SYMBOL. The alphanumeric char- 
acters are drawn on a seven by seven grid. The three 
right-most columns in the grid do not contain parts of the 
character, but serve as the inter-character space in a 
character string. Thus a ratio of 1 actually gives a 
character with a height-to-width of 7:4, since the grid has 
a he^ht-to-width ratio of 1. 

Call format: 

CALL RATIO(ratio) 

ratio The ratio between heights and widths of 
character rectangles. 



The SYMBOL routine interprets its arguments in one of 
two ways, depending on the sign of the final parameter, n. 
If n is greater than or equal to 0, the character string 
mode is used, and if n is less them 0, then the centered 
symbol mode is used. These two modes of operation are 
described separately. 



The Charaetar String Mode (n^ 0) 

In this mode the SYMBOL routine draws a string of alpha- 
numeric characters with the starting-point at the lower 
left-hand corner of the first character. Figure 2-7a is an 
example. 

Call format: 

CALLSYMBOL(x,y,size,iarray,angle,n) 

x,y Coordinates of the starting-point of the 

string. If (x,y) equals (999.,999.), the 
current pen position is assumed to be 
the startii^-point of the character 
string. 

size An argument which performs two func- 
tions: 

1. Its absolute value is character 
height in inches. 

2. Its sign indicates the format of 
iarray unless n equals 0. Positive 
indicates AlO format is used. Neg- 
ative indicates Al format is used. 

iarray An array of BCD characters with the 
format and number selected by the size 
and n arguments. 

angle The angle, in degrees, with respect to 
the positive X axis, through which the 
baseline of the character strii^ is to be 
rotated. A positive angle implies coun- 
terclockwise rotation, and a negative 
ai^le a clockwise rotation. The center 
of rotation is the starting-point (x,y) of 
the character string. 

n The number of characters in iarray. 

n > The number of characters in 
iarray. 

n = One character is to be taken 
from the right-most character 
position of the first word of 
iarray (for example, 

IARRAY(1)=1RA). 

n < Refer to centered symbol 
mode (below). 
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The Centered Symbol Mode (n < 0) 

In this mode a line of the type specified by the n 
parameter is drawn to point x,y, where a centered symbol 
(specified by the isym parameter) is drawn. An example is 
shown in figure 2-7b. 

Call format: 

CALL SYMBOL(x,y,size,isym,angle,n) 

x,y The coordinates of the center of the 

centered symbol to which a line is 
drawn from the end-point of the pre- 
vious display element produced by a call 
to a graphic data routine. If (x,y) = 
(999.,999.), the current pen position is 
assumed to be the center of the 
centered symbol. 

size The height, from bottom to top, of the 
centered symbol to be plotted. 

isym An integer between and 13 selecting 
which of the centered symbols to be 
plotted (refer to appendix C). 

angle The ar^Ie in degrees that the centered 
symbol is rotated about its center. A 
positive value is a counterclockwise 
rotation. A n^ative value is a 
clockwise rotation. 

n A n^ative integer which selects the 

type of line which is generated from the 
starting-point to the center of the 
centered symbol. This is the first 
vector generated by this call. 



Ifn 


> 0, 


see character string 
mode is selected. 




= -1. 


draw an invisible line 
is selected. 




-2. 


draw a solid line is 
selected 




-3, 


draw an invisible line 
is selected. 




-4. 


draw a dashed line is 
selected. 




-5. 


draw a dotted line is 
selected. 




-6 
through 
-11 


draw a solid line is 
selected. 




-12. 


draw a solid line with 
scale and offset 
applied is selected. 



-13, draw an invisible line 

with scale and offset 
applied is selected. 

-14, draw a dashed line 

with scale and offset 
applied is selected. 

-15, draw a dotted line 

with scale and offset 
applied is selected. 

< -15, draw a solid line with 

scale and offset 
applied is selected. 
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c- 

c 

c- 



c- 

c 

c- 



PR06RAH EXAMP7 (OUTPUT) 
DIMENSION X<5)*Y<5) 
DATA X/1.5*2.5*3.5f4.5f5.5/ 
DATA Y/2.0t2.5*3.0*2.5i2.0/ 

INITIALIZE* DEFINE AND FRAME A PICTURE 

CALL PLTFIL 

CALL NEWPLT(It0.0*0.0*7.0«5.0*0.0»0.0»0t7HSYMBOL2) 

CALL PLOT(0.0.0.0t-3) 

CALL PLOT(7.0»0.0«2) 

CALL PLOT(7.0>S.0*2) 

CALL PLOT(0.0tS.0»2> 

CALL PLOT<0.0>0.0*2) 

DRAW A TITLE 

CALL RATIO<2.0) 

CALL SYMB0L(1.5*4.25t.S>16HCENTERE0 SYMBOLS»0.0*16) 

DRAW SYMBOLS WITH CONNECTING LINES OF TYPES -1 THRU -5 

CALL RATIO(I.O) 
DO 10 1=1*5 

CALL SYMBOL (X<I)>Y (I) >.75»1*0.0*-I) 
10 CONTINUE 

DRAW EACH SYMBOL AND ITS CORRESPONDING NUMBER 

XX=-.2S 
DO 20 Isl*l4 
J=I-1 
XX^XX+O.S 

CALL SYMBOL (XX •1.25* 0.2* J* 0.0*-l> 
CALL RATI0(1.25) 

CALL NUMBER(XX-.09.0.9.0,14»FLOAT(J)*0.0.-1) 
CALL RATIO(l.O) 
20 CONTINUE 

TERMINATE PLOTTING 

CALL PL0T(8. 0*0. 0*999) 
END 



CENTERED STHBOLS 



1 2 3 ■( 5 6 7 8 9 10 n 12 13 



Figure 2-7b. Centered Symbol Mode 
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ARC ROUTrNE 

The ARC routine draws a circular are. The format for the 
call is presented below, and figure 2-9 illustrates its use. 

Call format: 

CALL ARC(x,y,ar^le,xc,yc,io) 

x,y Coordinates of the startir^-point of the 

arc. 

angle The angle in d^rees swept out by the 
arc. If the angle is positive, the arc 
moves in a counterclockwise direction 
away from the starting point. If the 
angle is negative the movement is 
clockwise. 

xe,ye Coordinates of the center of the arc. 

ic An integer which selects the type of 

line used to draw the arc and controls 
the computation of coordinates using 
scales and offsets. If an iUegal value is 
specified, default to 2 occurs (solid 
line). 

If ic = 2, a solid line is used. 

4, a dashed line is used. 

5, a dotted line is used. 

12, a solid line with coordi- 
nates computed using 
scales and offsets is used. 

14, a dashed line with coordi- 
nates computed using 
scales and offsets is used. 

15, a dotted line with coordi- 
nates computed using 
scales and offsets is used. 



ic An integer which selects the type of 

line used to draw the arc and controls 
the computation of coordinates using 
scales and offsets. If an illegal value is 
specified, a solid line (2) will be drawn 
(as default). 

If ic = 2, a solid line is selected. 

4, a dashed line is selected. 

5, a dotted line is selected. 

12, a solid line with coordi- 
nates computed using 
scales and offsets is 
selected. 

14, a dashed line with coordi- 
nates computed using 
scales and offsets is 
selected. 

15, a dotted line with coordi- 
nates computed using 
scales and offsets is 
selected. 



TURNING ERROR MESSAGES ON OR OFF 

Routines ERRON and ERROFF can be called to turn on 
error message capability or turn it off. The following 
message turns the capability on. 

CALL ERRON 

The following message turns it off, 

CALL ERROFF 

When on, ERRON issues messages if errors occur (refer to 
appendix F); conversely, ERROFF disables error checking 
mode when it is selected. 



Alternate call format: (ARC2) 

CALL ARC2(x,y,xe,ye,xc,yc,isense,ie) 
x,y 



Coordinates of the startii^-point of the 
are. 



xe.ye Coordinates of the end-point of the arc. 
If they are the same as the start-point 
coordinates, a fuU circle is drawn. 

xe.ye Coordinates of the center of the arc. 

isense Direction in which the arc is formed. 

If isense = 0, the direction is counter- 
clockwise from the start- 
point. 

1, the direction is clockwise 
from the start-point. 



DEVICE MODE ROUTINES 

Three device mode routines are provided for cbmpatibility 
with ZETA 230 plotting devices. These routines place 
device mode records into the neutral picture file. Routine 
SMODE also sets the neutral plot routine ratio parameter 
to one per aspect. These routines are device dependent 
and should only be used if the ZETA is the desired plottii^ 
device. (Refer to the ZETA User's Guide, available from 
ZETA Research, Inc..) 

Call formats: 

CALL SLINE 

CALL CLINE 

CALL SMODE(ifast,aspect) 
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ADDITIONAL ROUTINES 

The followii^ routines are included for compatibility with 
the ZETA plotting routines. A call to any of these 
routines has no effect. 

Calls: 

CALL PON 

CALL POFF 

CALL TON 



Table 2-3 contains a list of the UNIPLOT routines. If your 
program contains routines with a name listed in the table, 
the names in your program must be changed. 



MULTIPLE PLOT ORIGINS 

Some programs use CALL PLOT(X,Y,-3) to define 
multiple origins within one plot. In order for UNIPLOT to 
provide a selective drawing capability, the post processor 
must interpret this call as the beginning of a new plot 
unless the NEWPLT routine is used. 



MERGING WITH A USER'S PROGRAM 

The UNIPLOT neutral plot routines are CalComp call 
compatible. The majority of programs making standard 
calls to the CalComp basic plotting software should be 
able to use UNIPLOT with no charges. However, there 
are some exceptions. The following is a list of possible 
incompatibilities. 

• If your program is overlaid, you may have to 
include two common blocks in the main (0,0) 
overlay. 

• If your program contains routines with names in 
common with UNIPLOT routines, those names 
must be changed. 

• If your pr(^am contains more than one CALL 
PLOT (X,Y,-3) per plot, you may wish to utilize 
the UNIPLOT PLTFIL and NEWPLT routines. 

• If your program uses more than the standard 
fourteen centered symbols, the additional sym- 
bols must be changed. 



AN OVERLAID PROGRAAA 

UNIPLOT uses two labeled common blocks for storing and 
transferring plot information. These common blocks are 
labeled /YCOM/ and /ZOOM/ and are 18 and 129 words in 
length, respectively. 

If the program is overlaid, with the calls to the UNIPLOT 
routines in a primary or secondary overlay, the following 
statements should be included in the main (0,0) overlay. 

C0MM0N/YC0M/UNI1(18) 

COMMON/ZCOM/UNI2(129) 

This addition to the main overlay ensures the plot in- 
formation is not destroyed when another overlay is loaded. 



DUPLICATE ROUTINES 

Besides eontainir^ the routines with names compatible 
with the CalComp basic plotting software, UNIPLOT 
contains an expanded set of user callable routines and 
some internally called routines. 



TABLE 2-3. UNIPLOT ROUTINES 



ADDF 


FASFIG 


NEWPLT 


SCALE 


ADDP 


FASGET 


PON 


SYMBOL 


ARC 


FASPUT 


POFF 


SLINE 


ARC2 


GETE 


PUTE 


SMODE 


AXIS 


GETF 


PUTH 


WHERE 


CLINE 


GETH 


TON 


XTRANS 


CUBIC 


GETP 


NUMBER 


XYCHECK 


DEACTF 


ICCHECK 


OFFSET 


ZDADO 


DEACTP 


INDEV 


PLOT 


ZPUT 


ENDGRP 


FACTOR 


PLOTS 


ZSLOPE 


ERRON 


GROUP 


PLTFIL 


ZTRANS 


ERROFF 


LINE 


RATIO 




FASEBP 


MIRROR 


REACTF 




BASEBU 


NEWPEN 


REACTP 





CENTERED SYMBOLS 

Some CalComp and Houston Instrument plotting software 
has the capability of using the fourteen special characters 
plus any of the standard sixty-four characters as centered 
symbols. UNIPLOT uses only the fourteen special 
characters as centered symbols (refer to appendix C). If a 
program uses one of the 64-charaeter sets as a centered 
symbol, the calls to routine SYMBOL must be changed to 
invoke the character string mode instead of centered 
symbol mode. In addition, an x and y offset must be 
calculated since the lower left corner of the character is 
placed at the coordinate specified, not at the center of 
the character. 
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USING THE POST PROCESSOR 



OVERALL OPERATION 



The default execution command is: 



It is assumed that the user is familiar with the NOS/BE or 
NOS operating systems, commands, and control cards as 
necessary, and is able to attach the UNIPOST file which 
contains the absolutized post processor program (refer to 
appendix A). 

The post processor uses the followii^ four files. 

NPFILE A neutral picture file. 

PLOTF The device dependent plot data output 

by the post processor.! 

OUTPUT A listing of the parameter input state- 
ments and eeroT messages. 

INPUT Post processor directives. 

The control card to initiate post-processor execution is as 
follows. 

UNIPOST, D=deviee, file options. 

device Keyname of desired device (appen- 

dix D). 



file options l=lfn 



Local file name contain- 
ii^ the post-processor di- 
rectives. 



UNIPOST. 

This command reads directives from INPUT, reads the 
neutral picture data from NPFILE, writes any informative 
messages to OUTPUT and creates a device dependent plot 
file named PLOTF. A directive record containing the 
DEVICE= name card must be supplied in the input stream 
(refer to Selecting a Device later in this section). 

This command format cannot be used on an interactive 
SCOPE 3.4/INTERCOM system unless INPUT and 
OUTPUT are connected prior to execution. 

AU of the pictures on the neutral picture file can be 
obtained with no modification by using the followir^ 
command. 

UNIPOST,D=device name. 

Using this command eliminates the need to provide a 
directive record on INPUT, since the post-processor 
defaults all directive values. If special directives are 
needed, an I must be added to the command as follows: 

UNIPOST,D=device name,I. 

This is the format which should be used for interactive 
SCOPE/INTERCOM. Add the I only if post-processor 
directives are to be used. 



I Default to reading direc- 

tives from INPUT. 

1= (Omitted), do not read di- 

rectives if D is present; 
otherwise, default to 
reading directives from 
INPUT. 

0=lfn Local file name to which 
all informative messages 
are written. 

0= (Omitted) write informa- 

tive messages to 
OUTPUT. 

F=lfn Local file name of the 
neutral picture file. 

F= (Omitted), default to 

reading neutral picture 
data from NPFILE. 

P=lfn Local file name to which 
the device dependent plot 
data is written. 

P= (Omitted), write device 

dependent plot data to 
PLOTF. 



The logical file names of files NPFILE, PLOTF, OUTPUT, 
and INPUT may be changed (for example, respectively to 
PLOTIN, PLOTOUT, LIST, and DIRECT) by executing the 
post processor via a control card in the following form: 

UNIPOST, F=PLOTIN. P=PL0TOUT, 0=LIST, I=DIRECT. 



DIRECTIVE INPUT STATEMENT SYNTAX 

All directive statements take the form: 

directive name = values* 

The directive name may start in tmy character position in 
the record (that is, in any card column), and may continue 
over record boundaries. Eighty characters are scanned in 
each reccM-d. All blanks, even those within names and 
numbers, are %nored. The asterisk (*) is the delimiter 
between directives. 

The set of legal directive names, along with the values 
permitted for each directive, is provided later in this 
chapter in the section entitled Post Processor Directives. 
The directive names must be less than or equal to ten 
characters and may be shortened to their first four char- 
acters. 



tThe SC4020 device writes to FILMPL. 
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MIRRORING 

Mirroring is accomplished by executing a MIRROR direc- 
tive before the appropriate DRAW or DELETE statement. 
The values of the MIRROR statement select mirroring in 
the X or Y dimension (or no mirroring), and if mirroring is 
selected, optionally define the line in the virtual space 
about which mirroring takes place. 

Example: 

MIRROR = Y, 2.0* 
DRAW = 1* 
MIRROR = OFF* 
DRAW = 1* 
MIRROR = X* 
DRAW = 1$ 



This example turns on mirroring, draws picture A 
mirrored about a line which intersects the Y axis at the 
point 2.0 (refer to figure 3-1), and then turns mirroring off 
and draws picture A again without mirroring. Picture 
A is drawn for a third time, with mirroring in place in 
the X direction. 



WINDOWING 

The selection of a rectangular area within the virtual 
space, "windowing," is done using the WINDOW statement. 
The values of the window statement are two numeric 
ranges. Figure 3-2 illustrates the relationship of the axes 
to placement of window. 



PICTURE A 

WITHOUT 

MIRRORING 



PICTURE A 

MIRRORED ABOUT 

THE LINE Y=2.0 



4- 

3 
-2 



I - 




4 
THE LINE ABOUT WHICH ^ 
MIRRORING TAKES PLACE 



I • 



12 3 4 5 




PICTURE A 
MIRRORED IN PLACE 
ABOUT X 
(SAME AS X,3.0) 



I .. I 



2 3 4 5 



Figure 3-1. Mirroring 
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ORIGINAL 



SCALE s 2.0% 




SCALE = 4.0H 



Figure 3-4. Modify with SCALE 



PICTURE SIZE 

The size of the picture may be varied by the SCALE or 
SIZE statements. The SCALE statement sets scale 
factors that multiply all coordinates of the picture. The 
X and Y coordinates may be multiplied by different values 
if two values are present in the scale statement. If the X 
and Y coordinates are multiplied by different values the 
picture is distorted when it is displayed or plotted. Figure 
3-4 illustrates a two-dimensional square scaled upward 
using SCALE. 



The SIZE statement specifies the length of the sides of a 
rectangle in inches on the display surface into which the 
selected window is to be fitted. This rectangle is called 
the display area (refer to figure 3-5). The picture is not 
distorted, even though some space in the display area is 
not filled by the windowed graphic data. SIZE is not to be 
confused with SURFACE which specifies the physical 
dimensions of the entire display surface available (that is, 
the total length and width of a paper roll for a drum 
plotter). Various examples of windowing are shown in 
figure 3-6. 



WINDOW = 0-10, 0-20* 
SIZE = 5, 5* 
ORAW= I* 



DRAWING 
WINDOW 


UNUSED 



Figure 3-5. Window Size 
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SELECTIVE MODE 



ROTATE = ON* 



If the display device selected is a CRT, the selective 
mode is default. This mode places the lower left-hand 
corner of the picture window at the lower left-hand 
corner of the display surface unless otherwise specified by 
the ORIGIN directive. 

The selective mode is also valuable for its "cut and paste" 
capability which could be used to position a string of 
pictures on a flat-bed plotter to make use of the entire 
surface. This is done by using the ORIGIN directive whose 
values are the X and Y display surface coordinates of the 
lower left-hand corner of the window. 

Example: 

ORIGIN = 17.5, 4* 

The previous directive places the drawing 17.5 inches to 
the right and 4 inches above the or^in. (The or^in is the 
lower left-hand corner of the display.) 

When selective mode is used on a device that is not a 
CRT, an ORIGIN directive must be used before the DRAW 
directive for each picture or overplotting occurs. 

The available space on the display surface may be such 
that a rectangle selected by WINDOW needs to be turned 
sideways (90 in a counterclockwise direction) by the 
ROTATE statement. 



The ROTATE directive remains active until it is turned 
off by the statement: 

ROTATE = OFF* 

In the following example segments of pictures 1, 2, and 6 
are selected and placed on a 24 inch by 16 inch display 
surface. 

WINDOW = 0-10, 0-15* 
ORIGIN = 1, .5* 
DRAW = 1* 
WINDOW = 0-5, 0-3.5* 
SCALE = 2* 
ORIGIN = 13, ,5* 
DRAW = 2* 

WINDOW = 5-10, 3-10* 
SCALE = 1* 
ORIGIN = 13, 8.5* 
ROTATE = ON* 
DRAW = 6$ 

This set of parameter statements results in the layout 
illustrated in figure 3-7. 

A more extensive example of the use of window and the 
selective mode, to enlarge a selected portion of a 
picture, is found under WINDOW Statement later in this 
section. 



.5^ 



{I, .5) 

(13. .5) 
(13,8.5) 15 



.•OL 



PICTURE I 



PICTURE 6 



1« — 


— 7 »l 


B 


PICTURE 2 



■iO' 



->l2..k- 



-10' 



2.5" 



T 

5" 

i. 



Figure 3-7. Picture Layout 



60454730 A 



3-7 



statement format: 



DRAW STATEMENT 



SURFACE = xlength, ylength* 

xlength Horizontal length of the display 

surface in inches. This is the 
length of the roll of paper on a 
drum plotter or the length of the 
bottom edge of a flat-bed or CRT. 

ylength Vertical length of the display sur- 

face in inches. This is the width of 
the paper on a drum plotter or the 
number of inches from the bottom 
to the top of a flat-bed or CRT. 



Example: 



Assume the device being used is a Houston Instrument 
22-inch plotter attached to a 200 user terminal. The 
default size for DEVICE = HI200 is 11 by 1,440 
inches. If the default surface size were used, it 
would be impossible to obtain plots larger than 11 
inches. Therefore, the following statements would be 
used. 

DEVICE = HI200*SURFACE = 22, 1440* 



PEN STATEMENT 

The PEN statement allows the user to specify the number 
of pens available on his plotter if it differs from the 
default as listed in appendix D. 

Statement format: 



PEN = n* 



Number of pens available on the 
plotter. 



RESTORE STATEMENT 

The RESTORE statement serves two purposes. It restores 
all directive values back to their default <x moves the pen 
to the bottom edge of a plotter. 

Statement formats: 

RESTORE* 

or 
RESTORE = PEN* 

If the first fwmat is used, all directive values except the 
device name, increment, size and number of pens are reset 
to their defaults. This is particularly useful when usii^ an 
interactive device such as the Tektronix product. When 
the second format is used, the post processor generates a 
command to move the pen to the bottom of a pen plotter. 
If this feature is desired between every picture the 
followir^ sequence should be used. 

RESTORE = PEN*DRAW=1* 
RESTORE = PEN*DRAW=2* 
RESTORE = PEN*DRAW=3* 



The DRAW statement selects a set of pictures from the 
neutral picture file and displays them on the selected 
device. A maximum of 30 parameters may be used. All 
pictures specified are modified by the directive state- 
ments preceding the DRAW. Omitting the DRAW state- 
ment causes aU pictures on the neutral picture file to be 
displayed. 



Statement format: 



number 1 



number n 



DRAW^ 

or 
DRAW* 



numeric range 1 numeric range n 



number n 



numeric range n 



A positive integer in the pa- 
rameter list which specifies a 
picture on the neutral picture 
file to be plotted. 

An inclusive specified se- 
quence of picture on the neu- 
tral picture file to be plotted. 
The ends of the ranges must be 
positive integers or the key- 
word END which draw through 
the end of the data. 



Example: 

DRAW = 1,3,6-8,12-END* 

The [H*evious example displays pictures 1, 3, 6, 7, 8, and 12 
through the end of data. 

Example: 

DRAW* 

DRAW = 1-END* 

The previous examples along with omitting the DRAW 
display the entire neutral picture file. 



NOTE 



For a further description of the numeric range, 
refer to the Directive Input Statement Syntax 
earliOT in this section. 



DELETE STATEMENT 



The DELETE statement ^ecifies that all pictures from 
the neutral picture file except the ones specified in the 
parameter list are to be displayed on the selected device. 
A maximum of 30 parameters may be used. 
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type 1 An area for which the minimum and 

maximum virtual coordinates for X and 
Y are specified (for example, 
W1NDOW=0-8,0-11*) 

type 2 An- area for which the maximum Y 

virtual coordinate is omitted (for ex- 
ample, WINDOW=0-8,0-END*) 

type 3 An area for which the maximum X 

virtual coordinate is omitted (for ex- 
ample, WINDOW=0-END,0-11*) 

type 4 An area for which both of the maximum 

virtual coordinates are omitted (for 
example, W1NDOW=0-END,0-END*) 

It should be noted that a default window is always present 
as ^ecified by the user program. If END is used in place 
of a maximum coordinate, the default value is used. 

If a user wishes to use the window statement, he or she 
should use the INFORM statement to determine the 
virtual coordinates of the default window. 

Window maxima and minima refer to the virtual space or 
user coordinates of the neutral picture file, before any 
scalir^, mirrorir^ or rotating takes place. For an example 
of windowing, refer to figures 3-6 through 3-9. 



The above directive lists the information for pictures 1, 5, 
8, 9, 10, and 11 and displays all pictures (omittii^ the 
DRAW directive defaults to display everything on the 
neutral picture file). 



SCISSOR STATEMENT 

The SCISSOR statement allows the user to turn <mi and off 
the scissoring feature of the post processor. If a line or 
character extends across the window boundary or outside 
the display surface, and scissoring is activated, the line is 
truncated at the point of intersection. Default is OFF 
unless the WINDOW directive has been used. This value 
remains set until another SCISSOR directive is encoun- 
tered. 



Statement format: 



SCISSOR = 



ON 



OFF 



If partitioning of a picture is desired in linear place- 
ment mode which is default for a drum plotter, use the 
foUowii^: 

MODE = LINEAR* 
SCISSOR = ON 



INFORM STATEMENT 

The INFORM statement allows the user to obtain a list of 
the default window in the virtual ^ace for each picture 
displayed. This window can then be used to determine the 
position in the virtual space of any portion of the picture. 



Statement format: 



number 1 



number n 



INFORM = 

or 
INFORM* 



numeric range 1 ,..., numeric range n 



number n A positive integer which speci- 

fies a picture on a neutral 
picture file for which the win- 
dow information is printed. 

numeric rar^e n An inclusive specified se- 
quence of pictures on the neu- 
tral picture file for which the 
window information is printed. 
The ends of the ranges must be 
positive integers or the key- 
word END which lists through 
the end of data. 

If the window information is wanted before any pictures 
are displayed, the DELETE statement must be used in 
conjunction with INFORM as follows: 

1NF0RM*DELETE* 

This example lists the information for all pictures on the 
neutral picture file without displaying any of them. 

INFORM = 1, 5, 8-11 * 



ROTATE STATEMENT 

The ROTATE statement causes the window to be rotated 
90" counterclockwise on the display surface and the new 
lower left-hand corner of the window placed at the speci- 
fied display surface origin. 



Statement format: 



ROTATE : 



ON 

OFF 



It should be noted that for rotation to be possible, the 
window must have definite maximum coordinates. 



MIRROR STATEMENT 

The MIRROR statement allows a user to obtain mirror 
image displays of neutral picture file pictures. 



Statement format: 



MIRROR = 



number 1 



number 2 



OFF 



X, number 1 

Y, number 2 * 

OFF 

Optional X coordinate of a vertical 
line about which the picture is to 
be mirrored. 

Optional Y coordinate of a hori- 
zontal line about which the picture 
is to be mirrored. 

No mirroring. 
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Figure 3-9. Virtual Picture Creation 



NOTE 



The Tektronix 4014 automatically initiates 
MODE=SELECTIVE, 



lOi 



DRAW=1* 



Display the first picture of the 
neutral picture file plaeii^ the 
lower left-hand corner of the 
default window (-10-10,-10-10) 
at the default origin (0,0) of 
the display surface. 



NOTE 



The various dotted lines in the drawings are 
not displayed, but are used in the examples to 
show the area of the window on the display 
surface. 



i JL. 



G 



C3 






O 



U 



8 10 12 14 



Figure 3-10. Window Area on Display Surface 

Figure 5-11 illustrates how the display appears when only 
the center of the original virtual picture (figure 3-9) is 
called into the window by the following directives: 
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TABLE 3-1. POST PROCESSOR DIRECTIVES 



Directive 



CHAR= HARD* 
= SOFT* 

DELETE = picture number* 



DEVICE = keyname* 
= DUMP* 



DRAW = picture numbers* 
INCR - increment* 

INFORM = picture number* 



MIRROR = X.const* 
= Y.const* 
= OFF* 

MODE = FILE* 

= LINEAR* 
= SELECTIVE* 



ORIGIN = x,y* 



OVERPLOT= ON* 
= OFF* 



PEN = n* 



RESTORE* 



RESTORE = PEN* 



ROTATE = ON* 
= OFF* 



SCALE = xfact.yfact* 



SCHAR = fact* 



SCISSOR = ON* 
= OFF* 



SIZE = xlei^th.ylei^th* 



SURFACE = length, width* 



WINDOW = xmin-xmax,ymin-ymax* 



Purpose 



Select hardware or software gen- 
erated characters 

Select the pictures which should not 
be displayed 

Select the display device or get a 
debug dump of the neutral picture 
file 

Select the pictures for display 

Select the increment size of the 
device 

Obtain a listing of the window in- 
formation for the specified picture 

Obtain a mirror image of the pic- 
tures specified on the following 
draw 

Select a placement mode 



Define the location on the display 
surface of the Iowct left-hand cor- 
ner of the window (used with SEL- 
ECTIVE mode) 

Specify if a screen erase wiU occur 
between pictures when displayed on 
a CRT 

Specify the number of pens on the 
device 

Reset all directives to the default 
values (does not affect DEVICE) 

Drive the pen to the bottom edge 
of a plotting device 

Rotate 90 degrees counterclockwise 
all pictures ^ecified on the follow- 
ing DRAW 

Reduce or enlarge the virtual pic- 
ture 

Scale the characters separately from 
the rest of the picture 

Specify scissoring of vectors if they 
cross display surface or window 
boundaries 

Define the size of the display area 
on the display surface 

Define the size of the display sur- 
face 

Define the portion of the picture to 
be displayed 



Default 



SOFT 

All displayed 

Fatal error 

All displayed 
Refer to appendix D 

No list 

OFF 



FILE for flat-bed devices; LINEAR 
for drum devices; SELECTIVE for 
CRT 



0,0 

OFF 

Refer to appendix D 
No action 
No action 
OFF 

1.0,1.0 

SCALE value 
ON 

Display surface size 
Refer to appendix D 
Refer to INFORM listing 
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CONTROL CARDS 



SCOPE 3.4 

The following is an example of compiling, loading and 
executing the user's UNIPLOT program and post-pro- 
cessing the neutral picture file in one job step on SCOPE 
3.4. 



Command 



Command 
MYJ0B,MT1. 
USER,... 

FTN. 

APPUC(UNIPLT) 
REQUEST,NPFILE, *PF. 

LGO. 



CATALOG,NPFILE,NPFILE. 
ID=MYID. 

FILE(PLOTF,RT=S,BT=C) 



REQUEST.PLOTF.MT.HI, 
RING,NL,SV. 

UNIPOST,D=TPLOT. 



Description 



Compile user's pro- 
gram. 

Attach UNIPLOT. 

Request permanent 
file space. 

Load and execute 
program. 

Catalog neutral pic- 
ture file. 

Define record type 
for plot tape, t 

Request the plot 
tape.t t 

Execute post pro- 
cessor with defaults. 



APPUC(UNIPST) 



ATTACH,NPFILE,ID=1VIYID. 



UNIPOST,D=HI200. 



REWIND,PLOTF. 



COPYBF,PLOTF,OUTPUT. 



6-7-8-9 



Description 

Attach the post pro- 
cessor. 

Attach the neutral 
picture file. 

Execute post pro- 
cessor. 

Rewind the plot file. 



Copy the plot file to 
OUTPUT. 



To CYBERUNK the neutral picture file to NOS for pre- 
viewing use the following. 



7-8-9 

PROGRAM MYPRO(OUTPUT) 



Command 
ATTACH,NPFILE,ID=MYID. 

COPYBR,INPUT,SEND. 

COPYBF,NPFILE,SEND. 

ROUTE,SEND,DC=FR,ST=id. 



Description 

Attach the neutral 
picture file. 

Copy the NOS control 
cards to the CYBER- 
LINK file. 

. Copy the neutral pic- 
ture fUe to the 
CYBERUNK file. 

CYBERUNK the 

filcttt 



CALL PLTFIL 




7-8-9 
JOB. 




• 

CALL PLOT(0,0.,999) 


User's program. 


ACCOUNT.number.pnsRWOTd, 
family. 




END 




CHARGE.number.jH'oject. 




6-7-8-9 




DEFINE,NPFILE. 


Define the permanent 
file. 



To execute the post-processor for an on-line device such 
as the Houston Instrument use the following: 



COPYBF,INPUT,NPFILE. 



6-7-8-9 



Copy the neutral pic- 
ture file to the per- 
manent file. 



tThe FILE card is not needed for most on-line plotting such as Houston Instrument or UNITECH. It should Mily be used 
if the device expects a binary formated file. CYBERNET users should list APPINFO for this information. 
1 1 Check with the local center for plottir^ [wocedure and format of the REQUEST card. No tape is required if plotting 
is done through a remote terminaL 
1 1 tid = KEA; System A 
KEB; System B 
KEC; System C 
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Command 



Description 



?2 



RECOVER/CHARGE: CHARGE, Enter charge number 
number, project if applicable. 



READY. 
NEW,MYPRO 

READY. 
TEXT 
ENTER TEXT 

PROGRAM MYPRO (OUTPUT) 

CALL PLTFIL 

CALL PLOT (0.,0.,999) 
END 

EXIT TEXT MODE 



Define a new local 
file. 



Enter text mode. 



INPUT DIRECTIVES 
?$ 



Enter program. 



Enter your terminal 
type. All NOS com- 
munications are 
asynchronous. 



Enter a $ to display 
all pictures with de- 
fault parameters. If 
an * is entered 
directives will again 
be requested after 
all pictures are dis- 
played. 



The pictures are now displayed. Whenever a bell sounds 
and a question mark is printed, type a C and a carriage 
return to continue. 

Use the following commands for post-processing to a 
ZETA plotter. 



Type BREAK key to 
exit text mode. 



Command 
-UNIPROC , S=lPOST (NPFILE = 

TAPE 1, fM =-mm 



Description 



READY. 




ENTER PLOTTER TYPE 




PACK 


Pack the new file. 


1=230, 2=1240, 3=3640 




READY. 




?1 


Specify a model 230. 


NOSORT 


Do not sort the file 


ENTER BAUD RATE 






by line numbers. 


?300 


Specify baud rate. 


READY. 




INPUT DIRECTIVES 




SAVE 


Save MYPRO as an 
indirect access file. 


?1NCR=.005$ 


Change the incre- 
ment size. 


READY. 




READY. 




DEFINE,NPF1LE=TAPE1. 


Use this command if 
the neutral picture 
file should be saved. 


REWIND, PLOTF 
READY. 


Rewind the plot file. 


-UNIPROC 
F=MYPRO' 


Execute user's pro- 
gram and post-pro- 
cess the neutral pic- 
ture file on a 


BATCH 
RFL, 20000. 


Enter batch mode. 




Tektronix 4014. 


/COPY, PLOTF 


Copy plot data tc 



ENTER TERMINAL TYPE 

1 = 4010 SYNCHRONOUS 

2 = 4010 ASYNCHRONOUS 

3 = 4014 SYNCHRONOUS 

4 = 4014 ASYNCHRONOUS 

5 = 4014 EGM SYNCHRONOUS 

6 = 4014 EGM ASYNCHRONOUS 



output to obtain the 
plot on the ZETA 
plotter. 



Use the following commands for post-processii^ to a 
Houston Instrument unit. 



Command 



ASCn 



Description 
Enter ASCII mode. 
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Command 

READY. 
SAVE 

READY. 
BATCH, 60000 

/FTN, I=MYPRO 

/ATTACH, UNIPLOT/UN= 
number 

/LIBRARY, UNIPLOT 

/DEFINE, NPFILE 

/LGO 

END MYPRO 

/ATTACH, UNIPOST/UN= 
number 

/UNIPOST, D=TEK 



Deseription 



Save MYPRO as an 
indirect access file. 



Enter batch mode re- 
questing 60,000 octal 
words of core. 

Compile MYPRO. 

Attach UNIPLOT li- 
brary from installa- 
tion user number. 

Define UNIPLOT as a 
library. 

Define permanent 
file space for the 
neutral picture file. 

Execute user pro- 
gram. 



Attach post-pro- 

cessor from installa- 
tion user number. 

Initiate execution for 
a Tektronix device. 



ENTER TERMINAL TYPE 

1 = 4010 SYNCHRONOUS 

2 = 4010 ASYNCHRONOUS 

3 - 4014 SYNCHRONOUS 

4 = 4014 ASYNCHRONOUS 

5 = 4014 EGM SYNCHRONOUS 

6 = 4014 EGM ASYNCHRONOUS 



?2 

DIRECTIVES 
?$ 



Enter your terminal 
type. 



Enter $ to display all 
pictures. Using an * 
causes a request for 
directives after all 
pictures are dis- 
played. 



NOS/BE 

The following is an example of a deck which would be 
submitted to NOS/BE through a batch terminal to create a 
tape for off-line plotting. 



Command 
MYJOB, MTl. 
USER, 

FTN. 

ATTACH, UNIPLOT, ID = 
UNIPLOT, MR=1. 

LIBRARY, UNIPLOT. 
REQUEST, NPFILE, *PF. 
LGO. 



CATALOG, NPFILE, 
ID=MYID. 

ATTACH, UNIPOST, ID= 
UNIPLOT, MR=1. 



Description 

Job card. 

Accountii^ informa- 
tion if applicable. 

Compile user's pro- 
gram. 

Attach UNIPLOT 
neutral plot routine. 

Define UNIPLOT as a 
library. 

Request permanent 
file space. 

Execute user's pro- 
gram. 

Catalog neutral pic- 
ture file. 

Attach the post pro- 
cessor. 



FILE (PLOTF, RT=S, BT=C) Define record type 

tar plot tape, t 



Description 
Request plot tape. 



Execute post pro- 
cessor. 



Command 

REQUEST,PL0TF,MT,H1, 
RING,N,VSN=XXXXX. 

UNIPOST,D=CAL570. 



7-8-9 

PROGRAM MYPRO(OUTPUT) 
CALL PLTFIL 

CALL PLOT(0.,0.,999) 
END 
6-7-8-9 



To execute the post processor for a device attached to a 
remote printer (that is, a Houston Instrument DP-3 on a 
200 user terminal), use the following. 



User's program. 



The pictures are now displayed. Whenever a bell sounds 
and a question mark is printed, type a C and a carriage 
return to continue. 



Command 

ATTACH,UNIPOST,ID= 
UNIPL0T,MR=1. 



Deseription 

Attach the post pro- 
cessor. 



tThis file card is only needed for those devices which expect binary formatted plot data if not output by a BUFFER 
OUT. 
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CHARACTER SET B 



Figure B-1 illustrates the UNIPLOT software produced are plotted in display code order from the top line to the 

character set available for plotting text. The characters bottom line in table B-1. 

TABLE B-1. UNIPLOT CHARACTER SET 

Octal Display Codes Plotted Characters Octal Display Codes Plotted Characters 



01 


A 


41 


6 


02 


B 


42 


7 


03 


C 


43 


8 


04 


D 


44 


9 


05 


E 


45 


+ 


06 


F 


46 


- 


07 


G 


47 


+ 


10 


H 


50 


/ 


11 


I 


51 


( 


12 


J 


52 


) 


13 


K 


53 


$ 


14 


L 


54 


= 


15 


M 


55 


blank 


16 


N 


56 


1 


17 


O 


57 




20 


P 


60 


s 


21 


Q 


61 


I 


22 


R 


62 


] 


23 


S 


63 


■T 


24 


T 


64 


* 


25 


U 


65 


•*' 


26 


V 


66 


V 


27 


w 


67 


A 


30 


X 


70 


♦ 


31 


Y 


71 


i 


32 


Z 


72 


< 


33 





73 


> 


34 


1 


74 


< 


35 


2 


75 


> 


36 


3 


76 


— 1 


37 


4 


77 


; 


40 


5 


00 


; 
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CENTERED SYMBOLS 



This plot contains the representation of the fourteen 
UNIPLOT centered symbols. 



UNIPLOT 

CENTERED SYMBOL 

SET 



CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 
CENTERED 



SYMBOL 

SYMBOL 1 

SYMBOL 2 

SYMBOL 3 

SYMBOL 4 

SYMBOL 5 

SYMBOL 6 

SYMBOL 7 

SYMBOL 8 

SYMBOL 9 

SYMBOL 10 

SYMBOL 11 

SYMBOL 12 

SYMBOL 13 



□ 
O 

X 

o 

X 



Y 
X 



Figure C-1. UNIPLOT Centered Symbol Set 
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SUPPORTED DEVICES 



The devices sdiown in table D-1 are supported by UNIPLOT 
under SCOPE 3.4 and NOS/BE. The keynames listed for a 
device are used on the UNIPOST control card or the 



DEVICE directive statement. Table D-2 lists devices 
supported by UNIPLOT under NOS. Contact the local CDC 
office if a needed device is missing. 



TABLE D-1. DEVICES SUPPORTED ON NOS/BE (SCOPE 3.4) 



Device 


Increment 


Size 


No. of 
Pens 


Keynames 


CalComp 770 Controller 
763 Plotter 


.005 


1728x28 


1 


BOSTON 

CAL770 

MPLSZIP 


CalComp 780 Controller 
763 Plotter 


.005 


1728x28 


1 


CAL780 
SUNNYVA 


CalComp 7-Track 
900 Controller 
936 Plotter 


.005 


1728x30 


3 


C9007T 
NEWYORK 


CalCoinp 9-Track 
900 Controller 
936 Plotter 


.002 


1728x30 


3 


C9009T 


CalComp 900 Controller t 
1136 Plotter 


.0025 


1440x34 


3 


ROCKVIL 


CDC 160-A/165 Controller 
CalComp 563 Plotter 


.001 


1200x30 


1 


LA 

MPLS 

PHILY 

TPLOT 

TUSCON 


CDC MARC IV Terminal 
CalComp 570 Controller 
565 Plotter 


.005 


1728x10 


1 


CAL570 
DALLAS 


CDC MARC IV Terminal 
CalComp 770 Controller 
763 Plotter 


.0025 


1728x30 


1 


MARC770 


CDC MARC m Terminal 
CalComp 915 Controller 
1136 Plotter 


.001 


1440x34 


3 


MARC915 


CDC 200 User Terminal 
Houston Instrument 
BTC-7 Controller 


.01 


1440x10.5 


1 


HI200 


COPE 1200 Terminal t 
200 UT Mode 
CalComp 563 Plotter 


.005 


1200x30 


1 


C0PE2UT 
COPEOCC 


Houston Instrument 
MTR4 7 Track Controller 
DP-7 Plotter 


.002 


1800x34.5 


3 


HOUSTON 
HIMTR47T 


Houston Instrument 
MTR4 9-Track Controller 
DP-7 Plotter 


.0025 


1800x34.5 


3 


HIMTR9T 
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WRITING A PLOTTING DEVICE CONTROL ROUTINE 



The following are the functions performed by a plotting 
device routine. After a listing of the functions, a sample 
routine is provided. 

• A labeled COMMON block, /ZOOM/, is provided 
with variable, ITYP, and an array, IBUF. 

• A plotting device routine converts its numeric 
arguments into a standard fixed-point decimal 
format. If the argument is an integer, the con- 
version is performed by the statement: 

J = 1*10000 

If the argument is a floating point, then the 
conversion statement is: 

J = IFIX (X*10000.0+SIGN(.5,X)) 

A BCD argument with a limit of 10 characters 
need not be converted. 

• The routine places the converted arguments into 
array IBUF, starting with IBUF(3), and going on 
to a maximum number of arguments at IBUF(14). 



• The routine places the name of the plotting 
device, a BCD string, in IBUF(l). This name is 
the same as the name used in the post processor 
DEVICE statement. 

• The routine also places the name of the present 
routine, a BCD string, in IBUF(2). 

• And lastly, the routine places an 11 in ITYP and 
calls routine ZPUT, which has no arguments but 
uses ITYP and IBUF in labeled common/ZCOM/ 
for communication. ZPUT writes the necessary 
data to the neutral plot file. 



Example: 



SUBROUTINE CAMRAV (ICAM) 

COMMON/ZCOM/ITYP,IBUF(3), 1(97) 

ITYP = 11 

IBUF(l) = 6HSC4020 

IBUF(2) = 6HCAMRAV 

IBUF(3) = ICAM*10000 

CALL ZPUT 

END 
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NEUTRAL PLOT ROUTINE ERROR CODES 



The neutral plot routines optionally return an error code to 
the calling program as previously described under Error 
Codes in section 2. If the returned code is zero, then no 
errors in the calling sequence were detected. If the 
returned code is nonzero, then the type of error is 
indicated by which bits are set in the code as shown below. 



BIT 



BITS 0-9: 



59 


12 


11 


10 


9 











=Error 
Code 



Bits through 9 are set when the 
parameter of corresponding number is 
out of range or has illegal value. For 
example, if the second and fourth 
parameters in a call to a neutral plot 
routine are out of range, bits 1 and 3 in 
the returned error code are set. 



BIT 10: Bit 10 is set when the parameter list in 

an ARC2 subroutine call does not define 
a circle. 

BIT 11: Bit 11 is set by the CUBIC subroutine 

when the nth and (n+2)th coordinate pairs 
in the X, Y points arrays are the same. 

BIT 12; Bit 12 is set by the USE subroutine when 

either the DELTAV or FIRSTV 
parameters are equal to zero. DELTAV 
and FIRSTV are usually computed by 
SCALE prior to calling LINE. 



NOTE 



The calling application need not initialize the error code 
prior to usir^ it in a call. 
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POST PROCESSOR INPUT SYNTAX ERRORS 



•***BAD NUMERIC RANGE 



••••DEVICE SPECIFIED ON CONTROL CARD 

••••FIELD XX INVAUD TYPE 
••••INVAUD CONTROL CARD 

••••INVAUD SYMBOIXS) PRECEDING= 



••♦•LINEAR MODE ILLEGAL FOR ALL BUT 
DRUM TYPE PLOTTERS 

••••ORIGIN NOT WITHIN PLOTTER LIMITS 



••••OVERPLOT REQUIRES SELECTIVE DEVICE 

♦•••PARAMETER COUNT EXCEEDS MAXIMUM LENGTH 

••••PARAMETER(S) MISSING 

♦•••PICTURE xxxxx NOT IN NEUTRAL PLOT FILE 

••••TOO MANY PARAMETERS 
••••WINDOW TRUNCATED 

••**xxxx CONTAINS ILLEGAL CHARACTER 
••**xxxx CONTAINS NEGATIVE PARAMETER 
****xxxx EXCEEDS MAXIMUM CHARACTER LENGTH 
****xxxx ILLEGAL KEYWORD 

••••xxxx IS AN ILLEGAL DEVICE 
••••xxxx IS AN INVALID DIRECTIVE 



Explanation 

1. Sec(mcl parameter in numeric range; if not, numeric is not 
END. 

2. If both parameters are numeric then first number is 
greater than second number. 

Device has been given on the UNIPOST control card and over- 
rides this specification. 

Field number in quotes is not the (Nroper type. 

The UNIPOST control card contains an error. Program is 
aborted. 

The UNIPOST control card has either more than one character 
or an illegal character preceding an = sign. Program is 
aborted. 

A MODE statement selected LINEAR plot placement but 
device is not a drum plotter. Processing continues. 

An ORIGIN statement specified that a drawii^ be placed 
outside the display surface. Processing continues. 

OVERPLOT has been turned on but device is not a selective 
type device. Processing continues. 

Maximum of 30 parameters on a directive has been exceeded. 

Directive is missing (me or more parameters. 

The drawing selected on a DRAW statement (or implicitly on a 
DELETE statement) was not found in the neutral plot file. 
Processing continues. 

Directive contains mwe parameters than permitted. 

A specified window lies outside the picture or outside the 
display surface upon transformation. Window limits are trun- 
cated to fit and processing continues. 

Parameter in quotes contains an illegal character. 

Directive in quotes contains a negative parameter. 

More than 10 characters in field. 

Parameter occurrii^ to right of an = in a directive is not a 
keyword recognized by UNIPLOT. 

The plottir^ device specified by the DEVICE statement or 
UNIPOST control card is not supported by UNIPLOT. Pro- 
cessing continues with the next input statement. 

Not a UNIPLOT directive. 
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NEUTRAL PICTURE FILE DUMP 



H 



A dump of the neutral picture file is obtained by the 
following: 

UNIPOST,D=DUMP. 

7-8-9 

DUMP=1$ for single picture 

or 
DUMP=1-END$ for an inclusive numeric range. 

If DUMP is used on an INTERCOM system, INPUT and 
OUTPUT must be connected prior to executing UNIPOST. 
A sample dump is included at the end of this appendix 
(figure H-2). The following discussion describes the 
contents of the dump. 



FILE CREATION DATA 

This information uniquely identifies a neutral picture file 
and is printed at the beginning of each dump. 

JOB Job name used when the file was 

created. 

ACCOUNT Account name used when the file 

was created. 

DATE: Date that the file was created. 

TIME: Time of day that the file was 

created. 



PICTURE AND FIGURE DATA 



This heading is printed to indicate the beginning of picture 
and figure information. The headii^ will be printed once 
for each picture. 



PICTURE DATA 

Picture data is printed immediately foUowir^ the picture 
and figure data heading. This information will be printed 
once for each picture. 

PICT NO The picture number. 

PICT NAME The picture name. The name 

DEFAULT is given to a picture if a 
name was not included on the call 
that created the picture. This name 
appears for aU pictures created by 
UNIPOST. 

A Picture active/inactive status. All 

pictures created by UNIPOST are 
active 

=Y (Picture active) 
=N (Picture inactive) 



R 



Picture rotation 





- Picture is not to be ro- 

tated. 

1 - Picture is to be rotated. 


X - GRIG 


Picture X origin. 


Y - GRIG 


Picture Y origin. 


X-MAX 


Maximum picture X coordinate. 


XiVFTN 


Minimum picture X coordinate. 


XMAX 


Maximum picture Y coordinate. 


XMIN 


Minimum picture Y coordinate. 


FIGURE DATA 





F^ure information will be printed once for each figure of a 
picture. 

FIGURE NO. The figure number. 

A Figure active/inactive status. AU 

figures created by UNIPOST are 
active. 



=Y (Figure active) 
=N (Figure inactive) 

Figure X origin. 

Figure Y origin. 



XORIG 
Y ORIG 

ELEMENT DATA 



Element information is printed for each figure and im- 
mediately follows the figure data. 

A type code and variable number of words is printed for 
each element record contained on the neutral picture file. 
The number of words that are printed for records that 
contain a fixed number of entries remain constant. For 
example, one word will always be printed for the pen select 
records which have one entry (pen number). The number of 
words printed for records that contain entries that repeat a 
variable nuinber of times depends on the number of 
occurrences of the repeating entries and any fixed entries 
which are always contained within the record. For 
example, a vector record always contains three words as a 
fixed portion of the record and two additioned words for 
each vector contained in the record. Thus, a one-vector 
record would be printed in five words and a seven-vector 
record would be printed in 17 words. 

Element records are printed as an array. Contents of the 
individual words are dependent on the record type and the 
number occurrence of repeated entries. Record contents 
are printed in figure H-1. 
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H-1 



Definition of the record entries are as follows: 

Word Parameter 

1 IGNAM 

2 ISGNAM 

3 IPEN 

4 INUM 

5 INTEN 

6 ISTYLE 



7 


ISUB 


8 


IXCO 


9 


lYCO 


10 


lANG 


11 


ISYM 


12 


IHIGH 


13 


IRAT 


14 


IBCD 


15 


IXSCO 


16 


ITSCO 


17 


IXCCO 


18 


lYCCO 


19 


IV AL 



Contents 

Group name 

Sub-group name 

Pen number 

Number of occurrences of a set of repeating parameters. 
Number of characters for a BCD character string. 

Intensity to t>e used when displaying the display items. 

Ignore 

1 INTEN 16- New intensity setting. 

Line style 

Symbol plotters with interconnected lines. 

1 Symbol plotting only. 

2 Solid line. 

3 Invisible line. 

4 Dashed line. 

5 Dotted line. 

Subroutine name. 

X coordinate relative to previous X origin. 

Y coordinate relative to previous Y origin. 
Angle. 

BCD string-angle of base line. 

Symbol to be plotted. 

Character height. 

Ratio of character width to he^ht. 

Words containing character string. 

Starting X coordinate of an ARC. 

Starting Y coordinate of an ARC. 

X coOTdinate of center point of an ARC. 

Y coordinate of center point of an ARC. 
A parameter to be passed to a subroutine. 
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GLOSSARY 



Annotation The labels drawn at one inch spacii^ 

along the axis. 

A[^]ication The programmer who writes graphics 

programma programs making calls to UNIPLOT. 

Although the console operator and ap- 
plication prc^ammer may at times be 
the same person, this term refers only 
to the fffogrammer. 

Argument Parameters entered by the graphics 

program in a call to the UNIPLOT 
routines. 

Centered symbol A special symbol which can be drawn 
with a virtual point at its center. 



Command mode 



CRT 

Device 

independent 

fUe 



Directive 



The INTERCOM (or TELEX) mode 
which allows the graphics terminal user 
to enter and execute time-sharing com- 
mands directly from the terminal. 

Cathode-ray tube. 

A plot data file which can be displayed 
on any device through post-processing. 
It is not in a format compatible with 
any specific device. 

The input to the post-processor which 
controls device specification size and 
placement. 



Directive record The file containing the post-processor 
directives: usually INPUT. 



Display area 



Display device 



A rectangular portion of the display 
surface in which the picture is dis- 
played. The display area is defined by 
the SIZE directive. 

A device capable of presenting, on a 
viewing surface or image stfea, the 
display elements that provide a visual 
representation of data, for example, 
cathode-ray tube, pen plotter, or micro- 
film plotter. 



Display elements The basic building symbols used by an 
application to construct display images, 
for example, absolute vectors and char- 
acters. 

Display image The collection of display elements 
which are visually represented together 
in a specified region of the display 
surface of a display device. 

Display surface The medium upon which a display image 
is produced, for example, CRT screen, 
film, or paper. 

Factor A special form of scale in winch a 

single multiplier is applied to both the 
X and Y axes. 



Figure 
Increment 



Inter-character 
space 



Mirror 



Mirroring 

Modal 
parameters 



Neutral picture 
fUe 



Neutral plot 
routines 

Offset 



Origin 

Partitionir^ 

Pen 

Pen restore 
Picture 



Plotting device 
Post processor 



A collection of display elements which 
contains its own or^;in. 

The smallest addressable unit available 
on a display device. 

The spacing between the characters in a 
character string. 

The reflection of display elements with 
respect to ^ecific straight lines on the 
display surface. 

The process of producing a mirror 
image of a picture. 

Those values set by user callable 
UNIPLOT routines that modify the size 
and placement of the picture. 

The device independent plot data file 
generated by the UNIPLOT neutral plot 
routines containing display elements 
generated by an application program. 

A library of UNIPLOT routines; a subset 
of which are CalComp call compatible. 

A value subtracted from the x or y 
coordinate in order to chtmge its posi- 
tion. 

The 0,0 point <m the display surface or 
in virtual space to which elU other 
points are related. 

The process of drawing in segments a 
picture which is too large to fit on a 
given display surface. 

A drawir^ instrument mounted in a 
display device that uses a paper display 
surface, or those parts of other display 
devices which perform analogous fun- 
ctions, for example, beam in a CRT. 

Moving the pen on a plotter to the 
bottom edge of the display surface. 

A collection of figures in the neutral 
file which is preceded by a header 
record generated by NEWPLT or PLOT. 
A picture contains one figure if the 
header record is generated by PLOT. 

Refer to display device. 

The application program, UNIPOST, 
which reformats the neutral picture file 
into data acceptable to the display 
device. 
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INDEX 



Annotation I-l 
ARC routine 2-1,19 
ARC2 routine 2-1,20 
Areas 3-10 
Argument I-l 
Argument check 2-3 
AXIS routine 2-1,11 



Cal comp 1-1; 2-1,21 

Centered symbol 2-11,13,15,21; C-1; I-l 

CHAR directive 3-15 

Characters 3-15 

Character scalii^ 3-6 

Character set B-1 

Character string 2-13,16,21 

CLINE 2-19 

Command mode I-l 

Common blocks 2-21 

Control cards A-1 

CYBER NOS A-4 

CYBERNET NOS A-2 
CRT 3-7.12.15; I-l 
CUBIC routine 2-2.13 
Cubic spline curve 2-14 
CYBER NOS control cards A-4 
CYBERLINK A-1 
CYBERNET A-1 
CYBERNET devices 3-2 
CYBERNET NOS control cards A-2 



Debug dump 3-15 

Default window 3-4 

DELETE directive 3-2,3,8,9,10,11,15 

Device 3-1 

Device control 2-2 

Device control routines E-1 

DEVICE directive 3-2,8,15; D-1 

Device keynames D-1 

Device mode routines 2-19 

DEVICE name card 3-1 

Device types 3-8; D-1 

Display area 3-5,12,15; I-l 

Display device 1-1 

Display elements I-l 

Display imc^e I-l 

Display surface 3-6.8.15; I-l 

DIMENSION statement 2-1 

Directive I-l 

Directive record 3-1; I-l 

Directive statements 3-1 

CHAR 3-15 

DELETE 3-2.3,8,9,10,11,15 

DEVICE 3-2,8,15; D-1 

DRAW 3-3.4,7,8,9,10,11,15 

INCR 3-2,8,15 

INFORM 3-4,10,11,15 

MIRROR 3-2,3,11,15 

MODE 3-4,6,12,15 

ORIGIN 3-4,7,12,14,15 



OVERPLOT 3-12,14,15 

PEN 3-2,9,15 

RESTORE 3-9,10,12,15 

ROTATE 3-7,11,15 

SCALE 2-1; 3-2,4,5,8,10,15 

SCHAR 2-1; 3-6,10,15 

SCISSOR 3-8,11,15 

SIZE 3-2,4,5,10,12,14,15 

SURFACE 3-2,5,8,15 

WINDOW 3-3,7,8,10.12.14,15 
Directive values 3-9 
DRAW directive 3-3,4,7,8.9.10.11,15 
Drawing placement 3-6 
Duplicate routines 2-21 



Element data H-1 
END keyword 3-2,9,10.11 
Erase operations 3-12 
Erase, screen 3-15 
ERROFF routine 2-3.19 
ERRON routine 2-3.19 
Error checking 2-19 
Error codes F-1 
Error return 2-3 
Errors, post processor G-1 
Errors, syntax 3-1 
Execute program A-1 



Factor I-l 

FACTOR routine 2,2,3,9 
F^ure 2-4,6; 3-2; I-l 
FUe, CYBERUNK A-1 
File, INPUT 3-1,12 
FUe, OUTPUT 3-1; A-1 
File, PLOTF 3-1,2 
File dump H-1 
File mode 3-6,8,12 
Floating point number 2-18 



Glossary 1-1 
Graphic data 2-1,2 



Houston instrument 2-21; 3-2,9; A-3,5 



INCR directive 3-2.8.15 
Increment 3-8; I-l 
Increment size 3-2,15 
INFORM directive 3-4,10,11,15 
Initialization 2-1 
Initialize 2-3 
INPUT file 3-1,12 
INTERCOM 3-1; H-1 
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WHERE routine 2-9 

Window 2-1,9; 3-12 

Window maxima 3-11; 1-2 

Window minima 3-11; 1-2 

Window i^ze 3-5 

WINDOW directive 3-3.7,8,10,12,14,15 

Window, virtual 1-2 

Windowing 3-2,3,5 



YCOM 2-21 



ZCOM 2-21; E-1 

ZETA plotter 2-19,21; A-2,3 

Zoom 3-12,14 
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